home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / rlog.z / rlog
Text File  |  1998-10-20  |  10KB  |  199 lines
  1.  
  2.  
  3.  
  4. RRRRLLLLOOOOGGGG((((1111))))                                                                RRRRLLLLOOOOGGGG((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rlog - print log messages and other information about RCS files
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      rrrrlllloooogggg [ _o_p_t_i_o_n_s ] _f_i_l_e ...
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      rrrrlllloooogggg prints information about RCS files.
  16.  
  17.      Pathnames matching an RCS suffix denote RCS files; all others denote
  18.      working files.  Names are paired as explained in cccciiii(1).
  19.  
  20.      rrrrlllloooogggg prints the following information for each RCS file: RCS pathname,
  21.      working pathname, head (i.e., the number of the latest revision on the
  22.      trunk), default branch, access list, locks, symbolic names, suffix, total
  23.      number of revisions, number of revisions selected for printing, and
  24.      descriptive text.  This is followed by entries for the selected revisions
  25.      in reverse chronological order for each branch.  For each revision, rrrrlllloooogggg
  26.      prints revision number, author, date/time, state, number of lines
  27.      added/deleted (with respect to the previous revision), locker of the
  28.      revision (if any), and log message.  All times are displayed in
  29.      Coordinated Universal Time (UTC) by default; this can be overridden with
  30.      ----zzzz.  Without options, rrrrlllloooogggg prints complete information.  The options
  31.      below restrict this output.
  32.  
  33.      ----LLLL  Ignore RCS files that have no locks set.  This is convenient in
  34.          combination with ----hhhh, ----llll, and ----RRRR.
  35.  
  36.      ----RRRR  Print only the name of the RCS file.  This is convenient for
  37.          translating a working pathname into an RCS pathname.
  38.  
  39.      ----hhhh  Print only the RCS pathname, working pathname, head, default branch,
  40.          access list, locks, symbolic names, and suffix.
  41.  
  42.      ----tttt  Print the same as ----hhhh, plus the descriptive text.
  43.  
  44.      ----NNNN  Do not print the symbolic names.
  45.  
  46.      ----bbbb  Print information about the revisions on the default branch, normally
  47.          the highest branch on the trunk.
  48.  
  49.      ----dddd_d_a_t_e_s
  50.          Print information about revisions with a checkin date/time in the
  51.          ranges given by the semicolon-separated list of _d_a_t_e_s.  A range of
  52.          the form _d_1<<<<_d_2 or _d_2>>>>_d_1 selects the revisions that were deposited
  53.          between _d_1 and _d_2 exclusive.  A range of the form <<<<_d or _d>>>> selects
  54.          all revisions earlier than _d.  A range of the form _d<<<< or >>>>_d selects
  55.          all revisions dated later than _d.  If <<<< or >>>> is followed by ==== then
  56.          the ranges are inclusive, not exclusive.  A range of the form _d
  57.          selects the single, latest revision dated _d or earlier.  The
  58.          date/time strings _d, _d_1, and _d_2 are in the free format explained in
  59.          ccccoooo(1).  Quoting is normally necessary, especially for <<<< and >>>>.  Note
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RRRRLLLLOOOOGGGG((((1111))))                                                                RRRRLLLLOOOOGGGG((((1111))))
  71.  
  72.  
  73.  
  74.          that the separator is a semicolon.
  75.  
  76.      ----llll[_l_o_c_k_e_r_s]
  77.          Print information about locked revisions only.  In addition, if the
  78.          comma-separated list _l_o_c_k_e_r_s of login names is given, ignore all
  79.          locks other than those held by the _l_o_c_k_e_r_s.  For example,
  80.          rrrrlllloooogggg ----LLLL ----RRRR ----llllwwwwfffftttt RRRRCCCCSSSS////**** prints the name of RCS files locked by the
  81.          user wwwwfffftttt.
  82.  
  83.      ----rrrr[_r_e_v_i_s_i_o_n_s]
  84.          prints information about revisions given in the comma-separated list
  85.          _r_e_v_i_s_i_o_n_s of revisions and ranges.  A range _r_e_v_1::::_r_e_v_2 means revisions
  86.          _r_e_v_1 to _r_e_v_2 on the same branch, ::::_r_e_v means revisions from the
  87.          beginning of the branch up to and including _r_e_v, and _r_e_v::::  means
  88.          revisions starting with _r_e_v to the end of the branch containing _r_e_v.
  89.          An argument that is a branch means all revisions on that branch.  A
  90.          range of branches means all revisions on the branches in that range.
  91.          A branch followed by a .... means the latest revision in that branch.  A
  92.          bare ----rrrr with no _r_e_v_i_s_i_o_n_s means the latest revision on the default
  93.          branch, normally the trunk.
  94.  
  95.      ----ssss_s_t_a_t_e_s
  96.          prints information about revisions whose state attributes match one
  97.          of the states given in the comma-separated list _s_t_a_t_e_s.
  98.  
  99.      ----wwww[_l_o_g_i_n_s]
  100.          prints information about revisions checked in by users with login
  101.          names appearing in the comma-separated list _l_o_g_i_n_s.  If _l_o_g_i_n_s is
  102.          omitted, the user's login is assumed.
  103.  
  104.      ----TTTT  This option has no effect; it is present for compatibility with other
  105.          RCS commands.
  106.  
  107.      ----VVVV  Print RCS's version number.
  108.  
  109.      ----VVVV_n Emulate RCS version _n when generating logs.  See ccccoooo(1) for more.
  110.  
  111.      ----xxxx_s_u_f_f_i_x_e_s
  112.          Use _s_u_f_f_i_x_e_s to characterize RCS files.  See cccciiii(1) for details.
  113.  
  114.      rrrrlllloooogggg prints the intersection of the revisions selected with the options
  115.      ----dddd, ----llll, ----ssss, and ----wwww, intersected with the union of the revisions selected
  116.      by ----bbbb and ----rrrr.
  117.  
  118.      ----zzzz_z_o_n_e
  119.           specifies the date output format, and specifies the default time
  120.           zone for _d_a_t_e in the ----dddd_d_a_t_e_s option.  The _z_o_n_e should be empty, a
  121.           numeric UTC offset, or the special string LLLLTTTT for local time.  The
  122.           default is an empty _z_o_n_e, which uses the traditional RCS format of
  123.           UTC without any time zone indication and with slashes separating the
  124.           parts of the date; otherwise, times are output in ISO 8601 format
  125.           with time zone indication.  For example, if local time is January
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RRRRLLLLOOOOGGGG((((1111))))                                                                RRRRLLLLOOOOGGGG((((1111))))
  137.  
  138.  
  139.  
  140.           11, 1990, 8pm Pacific Standard Time, eight hours west of UTC, then
  141.           the time is output as follows:
  142.  
  143.                _o_p_t_i_o_n    _t_i_m_e _o_u_t_p_u_t
  144.                ----zzzz        1111999999990000////00001111////11112222 00004444::::00000000::::00000000        (_d_e_f_a_u_l_t)
  145.                ----zzzzLLLLTTTT      1111999999990000----00001111----11111111 22220000::::00000000::::00000000----00008888
  146.                ----zzzz++++00005555::::33330000  1111999999990000----00001111----11112222 00009999::::33330000::::00000000++++00005555::::33330000
  147.  
  148. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  149.          rrrrlllloooogggg  ----LLLL  ----RRRR  RRRRCCCCSSSS////****
  150.          rrrrlllloooogggg  ----LLLL  ----hhhh  RRRRCCCCSSSS////****
  151.          rrrrlllloooogggg  ----LLLL  ----llll  RRRRCCCCSSSS////****
  152.          rrrrlllloooogggg  RRRRCCCCSSSS////****
  153.  
  154.      The first command prints the names of all RCS files in the subdirectory
  155.      RRRRCCCCSSSS that have locks.  The second command prints the headers of those
  156.      files, and the third prints the headers plus the log messages of the
  157.      locked revisions.  The last command prints complete information.
  158.  
  159. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  160.      RRRRCCCCSSSSIIIINNNNIIIITTTT
  161.           options prepended to the argument list, separated by spaces.  See
  162.           cccciiii(1) for details.
  163.  
  164. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  165.      The exit status is zero if and only if all operations were successful.
  166.  
  167. IIIIDDDDEEEENNNNTTTTIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  168.      Author: Walter F. Tichy.
  169.      Revision Number: 5.7; Release Date: 1998/01/12.
  170.      Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  171.      Copyright c 1990, 1991, 1992, 1993, 1994, 1995 by Paul Eggert.
  172.  
  173. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  174.      ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1),
  175.      rcsfile(4), RCSsource(5)
  176.      Walter F. Tichy, RCS--A System for Version Control, _S_o_f_t_w_a_r_e--_P_r_a_c_t_i_c_e &
  177.      _E_x_p_e_r_i_e_n_c_e 11115555, 7 (July 1985), 637-654.
  178.  
  179. BBBBUUUUGGGGSSSS
  180.      The separator for revision ranges in the ----rrrr option used to be ---- instead
  181.      of ::::, but this leads to confusion when symbolic names contain ----.  For
  182.      backwards compatibility rrrrlllloooogggg ----rrrr still supports the old ---- separator, but
  183.      it warns about this obsolete use.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.